home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-20 / cagen23.zip / PRINTME.DOC < prev    next >
Text File  |  1991-05-29  |  14KB  |  350 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.       The CaGen Expediter is placed in the public domain by CaGen Software for
  9. the enjoyment and use of radio amateurs.  CaGen Software makes no warranty or
  10. guarantee regarding its performance.
  11.  
  12.       This program is 100% machine language and written for IBM and compatible
  13. personal computers using DOS version 3.2 or higher.  It provides the ability (if
  14. selected) to operate keyboard CW and transmit user-programmable messages and
  15. calling sequences with a multi-mode terminal controller.   The program can be
  16. used for contests in all modes.
  17.  
  18.       We urge you to make a backup copy of the program disk, using either the
  19. COPY or DISKCOPY commands available in DOS.  Use the backup copy for operation.
  20.  
  21.        Minimum hardware requirements are:
  22.  
  23.  
  24.         PC(MS)-DOS v 3.2
  25.         CGA, EGA or VGA Color
  26.         190K free memory
  27.         One disk drive
  28.  
  29.       A word about Terminal Controllers:
  30.  
  31.       We used the AEA PK-232 in developing this program.  We did not try any
  32. other type of controller, but an operator who fully understands proper command
  33. usage for his own controller unit should experience no difficulty using this
  34. software.  We made every effort to provide the ability to "talk" with any brand
  35. of controller.
  36.  
  37.  
  38.  
  39.  
  40.                   CaGen Software
  41.                4821 Rosecroft Street
  42.              Virginia Beach, VA  23464
  43.  
  44.                General Information
  45.  
  46.       Your disk should include the following programs:
  47.  
  48.        1.  INITIATE.EXE
  49.  
  50.        2.  GENFILE.EXE
  51.  
  52.        3.  LOGGER.EXE
  53.  
  54.        4.  PRINTLOG
  55.  
  56.        5.  PRINTDUP
  57.  
  58.       INITIATE.EXE is usually not used except as you set up the program on a
  59. computer for the first time.  It is used to specify items for program operation
  60. and to generate an environment file.
  61.  
  62.       GENFILE.EXE is a program that will create a specific log and a ".BAT" file
  63. for the particular contest you intend  to operate and log.  Once created, the
  64. name you choose for your file will  serve as the command to start the log
  65. itself.
  66.  
  67.       LOGGER.EXE is the program file that is the heart of the CaGen Expediter.
  68. It is alwaysed used when operating a contest or running a log, but will normally
  69. be activated through the ".BAT" file mentioned in GENFILE.EXE above.  As you
  70. look at the programs in more detail, you will see how they work together.
  71.  
  72.       PRINTLOG.EXE does exactly what its name implies.    It is run after the
  73. contest to print out the contents of the log file.
  74.  
  75.       PRINTDUP.EXE is a program that will read the log, sort its contents and
  76. print the Dupe Sheet required for most contests.  PRINTDUP.EXE will handle file
  77. sizes up to 3200 contacts.
  78.  
  79.  
  80.       INITIATE (Preparing the Disk Drive and Hardware Environment)
  81.  
  82.  
  83.       To use a hard disk drive, make an appropriate directory to hold the
  84. program and log files.    After doing so, copy the programs from your disk to this
  85. directory.
  86.  
  87.       To use floppy disk drive(s), place your program disk in Drive A.
  88.  
  89.       Once you have the programs properly located (either floppy or hard drive)
  90. enter the command "INITIATE".  You will see a screen indicating the current
  91. disk drive in the first field and the second field will be blank, but is the one
  92. in which you would see a subdirectory if appropriate.  These two fields are for
  93. information only.
  94.  
  95.       You will be asked to enter the CPU speed (either 4 or 8 MHz).  This is
  96. used to set the best sound characteristics for logging, dupe and error notifica-
  97. tion.
  98.  
  99.       If your CPU is faster than 8 MHz, the sound will be of short duration, but
  100. operation will not be otherwise affected. Choose the figure closest to your
  101. computer speed.
  102.  
  103.  
  104.       The next two prompts allow you to choose disk drive and directory for the
  105. program and log files.    You may select the same drive and specify a subdirectory
  106. if you wish.  You might wish to run the Expediter on your hard drive, but write
  107. all log files to another drive, such as a floppy or another hard drive.
  108.  
  109.     When entering a path designation, do NOT enter the drive designator
  110. again.    for instance, assume that you wish to place files in the following
  111. hard drive location:  C:\ham\cagen.  To accomplish this, you would simply enter
  112. "C" (no quotes) in the Drive field.  Then in the next field, just enter the
  113. following:  "ham\cagen" - (again - no quotes).
  114.  
  115.       When you have made your choices, depress the "F1" key to close the
  116. INITIATE program and generate a permanent Environment file (LOGGER.ENV).  It
  117. will not be necessary to run INITIATE again unless you wish to change these
  118. settings.
  119.  
  120.  
  121.       GENFILE (Preparing for the contest)
  122.  
  123.       The GENFILE program will create a data file and prepare a ".BAT" file to
  124. start the Expediter using that data file.  Assume you plan to enter the 1991
  125. Sweepstakes Contest.  You can generate a file called "SS91.CW" or "SS91CW.LOG"
  126. or whatever you wish to call it.  While it is not necessary to use the specific
  127. extension "LOG", it IS mandatory that an extension of some type be used in
  128. naming this file.
  129.  
  130.       For illustration, use "SS91.CW".  Type the following:  GENFILE SS91.CW.
  131. The program creates a file of that name and it also makes a file called
  132. "SS91.BAT", which will serve as a "starter" for the new log.  Type "SS91" to
  133. begin the program.  You will see a menu of options, starting with one one the
  134. left side of the screen which allows you to select the method for dupe checking
  135. of contacts and  whether you want to activate the CW Keyboard.    Once these two
  136. choices are made and you leave the options menu, this log will retain the two
  137. settings whenever it is re-started.  These two options cannot be changed in this
  138. particular log. Another log can always be prepared using GENFILE if you wish to
  139. have different choices for dupe checking or CW keyboard.
  140.  
  141.       If you activated the keyboard, you will now see that a third menu has
  142. appeared below the original two.  This is used to specify the TNC control
  143. characters and any stored messages.  These changes can be made by "stepping" the
  144. cursor to the appropriate field and enterning the desired information.
  145.  
  146.       Before doing this, you should continue with the upper right-hand menu,
  147. which allows you to set choices such as Band, Mode, Set Time, Set Date, etc.
  148.  
  149.       If you wish to change any of these items, move the cursor to the field
  150. using your cursor control keys or depress ENTER at each item to accept it as it
  151. is currently shown and moving the cursor down to the next field.  At the field
  152. you wish to change, enter a "Y" to indicate that you do want to change it and
  153. then enter the information you want in the field.
  154.  
  155.       When entering BAND or MODE you can use any designators up to 3 characters.
  156. For example, you can enter "160", "1.8", "80", "3.5", etc. for BAND and you can
  157. enter "CW", "A1", "A3", "SSB" or whatever you choose for MODE as long as it is 3
  158. characters  or less in length.    Note: if you are dupe checking, you must be
  159. consistent in your use of these designators.   "3.5" and "80" are two distinct
  160. bands - "CW" and "A1" are also distinctly different and will cause your dupe
  161. check to fail.
  162.  
  163.       RST: To enter sent and received reports during the contest or logging
  164. period leave this field blank. Press "Y" to enter default RST and after
  165. entering the CALL and pressing ENTER or TAB the CURSOR will step to the
  166. receive report field in the event you wish to make a change from the default
  167. value. To cause the CURSOR to go directly to the EXCHANGE field enter an
  168. "N" and report fields will be blank.
  169.  
  170.  
  171.       If you reset either time or date, the new setting will only take place in
  172. the computer's RAM - this is a temporary change and the original time or date
  173. will return when the program is restarted.
  174.  
  175.       The last menu, which only appears if you have chosen the CW keyboard
  176. option, is one which allows you to specify the COMM Port (default is 1), the
  177. "Command Character" for your TNC (default is CTRL-C), the CW start character
  178. (default is "X"), the CW Receive character (default is "R", the "DE" callsign to
  179. be sent (Default is none) and the CQ message and two "variable' messages.
  180.  
  181.       The various characters used for "Command", "CW start" and"CW receive
  182. depend upon the instructions for your particular TNC.  The defaults are those
  183. which we know to work with the AEA PK 232 controller.
  184.  
  185.       'CQ MESSAGE"
  186.  
  187.       What you enter here can be transmitted as your CQ message.  For example,
  188. you may wish to always call CQ using this sequence:
  189.  
  190.         "CQ SS de W4HIR W4HIR SS K"
  191.  
  192.       This message can be changed at any time during the contest by using the
  193. Options Menu.
  194.  
  195.       "EXCHANGE MESSAGE"
  196.  
  197.       Enter any message you want to send for the exchange.  If you want to
  198. insert a serial number in this exchange, just place "@" (no quotation marks) at
  199. the appropriate spot.
  200.  
  201.         If you wanted to send an exchange that was "599 (Ser #) VA", you would
  202. enter " 599 @ VA".
  203.  
  204.       "VARIABLE MESSAGES" (F2 and F8 keys)
  205.  
  206.       These can be any messages you might want to send during operation, or they
  207. can even be command sequences.    For example, you might prefer to operate at 33
  208. WPM as your "normal" speed during a contest, but occasionally you might find it
  209. helpful to slow down for a particular station.  If you entered "CTRL-C MSP 24"
  210. in the first variable message and "CTRL-C MSP 33" in the second variable
  211. message, you would be able to switch speeds just by tapping the F2 key for slow
  212. and the F8 key for fast.  You can put anything you want to in these two spots.
  213.  
  214.       The entries for these two messages will only be active as long as the
  215. program runs uninterrrupted.   If you stop the program and later restart it, it
  216. will be necessary to set the variable messages again.
  217.  
  218.     When you finish making all of the above entries, the cursor will jump
  219. back up to the original menu (RED) in the upper left corner of the screen.  If
  220. you are satisfied with all settings, you can move the cursor to the next menu
  221. (GREEN) and from this spot you may depress "Esc" to move to the actual logging
  222. program.
  223.  
  224.  
  225.  
  226.  
  227.       At this point you are looking at the options menu which is superimposed
  228. over the logging screen.  If you depress the ENTER key (default) you will see
  229. the menu disappear and the logging screen is ready for your first entry.
  230.  
  231.       Rather than going through every step of logging, we now direct your
  232. attention to the following two pages which detail the special key combinations
  233. used in the program.  They should allow you to use all of the program features.
  234.  
  235.       Have fun!  If you like the program and care to support us in our
  236. programming efforts, please send whatever donation you feel is appropriate.
  237.  
  238.       Like Bartles and James - "We thank you for your support!"
  239.  
  240.       Please contact us with comments, suggestions or questions about the
  241. Expediter program.
  242.                                  SPECIAL KEYS
  243.                                       1
  244.  
  245.  
  246.               Logging Screen Function Keys
  247.               ----------------------------
  248.  
  249.  
  250.       F1 = MENU
  251.  
  252.     ESC  = Abort QSO (Clear entry), blanks the CALL and EXCHANGE fields.
  253.  
  254.  
  255. SHFT+TAB = Step to PREVIOUS field, moves cursor counter clockwise through
  256.        the fields.
  257.  
  258.       TAB = Step to NEXT field, moves cursor clockwise through the fields.
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.             Search/Display Screen Function Keys
  270.             ----------------------------------
  271.  
  272.  
  273.       F1 = Display MENU
  274.  
  275. SHFT+TAB = Step to PREVIOUS field. When a record is displayed, will move the
  276.        cursor counter-clockwise through the fields.
  277.  
  278.      TAB = Step to NEXT field. When a record is displayed, this will step the
  279.        cursor clockwise through the fields.
  280.  
  281.     HOME = Display first six log records.
  282.  
  283.      END = Display last six log records.
  284.  
  285.  
  286.  
  287.  
  288.                                  SPECIAL KEYS
  289.                                       2
  290.  
  291.        Logging Screen Functions which apply ONLY when CW keyboard activated.
  292.        ---------------------------------------------------------------------
  293.  
  294.        F1 = Log MENU
  295.  
  296.        F2 = Transmit Variable message one.
  297.  
  298.        F3 = Transmit CQ message.
  299.  
  300.        F4 = Transmit the following message:  "SRI QSO B4".
  301.  
  302.        F5 = Transmit the "de" message (HISCALL de URCALL).
  303.  
  304.        F7 = Transmit the EXCHANGE message.
  305.  
  306.        F8 = Transmit Variable message two.
  307.  
  308.        F9 = Enable "one-liner".  Enter up to 80 characters, which will be
  309.         transmitted as soon as entered.  Press ENTER or ESC to cancel.
  310.             (Note:  If your "one-liner" exceeds 80 characters, the function
  311.         will automatically end at the 80th character, but if you wish to
  312.         continue a comment you may depress F9 again and continue on for
  313.             another 80 characters, which will be "chained" to the first
  314.         transmission.  You can carry on an entire QSO in this fashion,
  315.         if the need arises.
  316.  
  317.  
  318.  
  319.    PageUp = Transmit call showing in the CALL field (HISCALL).
  320.  
  321.   PageDwn = Transmit your call stored in the DE message (URCALL)
  322.  
  323. CTRL+PgDn = Transmit DE + your call stored in the DE message (de URCALL).
  324.  
  325.      Home = Transmit "QSL ".
  326.  
  327.       End = Transmit "TU " (Thank You).
  328.  
  329.  CTRL+End = Transmit "QRZ ".
  330.  
  331.  ` or ~   = Transmit "?".  (These are the Accent Grave or Tilde characters).
  332.  
  333.  
  334.      You will find these keys very useful in contesting and we encourage
  335.     you to experiment with their use.  As an example, in the last contest we
  336.     ran, we found it helpful in a QSO to use the following sequence of keys:
  337.  
  338.  
  339.       1. "PageUp - F7"
  340.           (HISCALL + EXCHANGE)    [Pause for his response]
  341.  
  342.       2. "Home+End+^End+^PageDwn"
  343.           (QSL+TU+QRZ+de URCALL K)    [Ready for another call]
  344.  
  345.  
  346.      There are numerous possibilities here and you will soon discover
  347.     the combinations that are best for your situation, whether you are
  348.     "running them" on a single frequency or are searching and calling in
  349.     response to others.
  350.